home *** CD-ROM | disk | FTP | other *** search
/ Gold Medal Software 3 / Gold Medal Software - Volume 3 (Gold Medal) (1994).iso / music / cmod101.arj / CMOD.DOC < prev    next >
Text File  |  1994-02-20  |  6KB  |  117 lines
  1.  
  2.                        CapaMod v1.01 documentation file
  3.  
  4.            Copyright (C) 1993,1994 Heikki Ylinen ( flap / Capacala )
  5.  
  6.  
  7.      1. HISTORY AND TECHNICAL INFO ETC.
  8.  
  9.    CapaMod is a 4,6 and 8 channel Pro/FastTracker module player. The reason
  10.  why I made this program is that there isn't a single good module player for
  11.  the PC. I mean, all players contain many bugs and there isn't a single player
  12.  which supports all the ProTracker 1.1b effects. In the EFFECT.TXT file you can
  13.  find a table containing effect info on three popular players and CapaMod. Just
  14.  simply look at it and say which player is the best in that matter. I have in-
  15.  cluded only these three players because DMP is so popular and GusMOD and JMP
  16.  are relatively good players. Of course I have been testing other players also
  17.  but I haven't included them in the table because of their insufficient effect 
  18.  support. For example players such as MDP ( PSi's player ), WOW, ZZPlay, GUS-
  19.  Play, Galaxy Module Player and Inertia Player do not usually support effects
  20.  like DelayPattern and JumpToLoop. Not to speak about how they support normal
  21.  effects such as Vibrato. Tremolo is also one effect that is played correctly 
  22.  with only few players. But with CapaMod everything is otherwise. Except for 
  23.  the support of effect Invert Loop. That is because I don't have any idea how
  24.  to support this particular effect. If you have some info about this effect,
  25.  please send me everything you know.
  26.    CapaMod is based on CapaPlay routines which are partly based on Cascada's 
  27.  GUSPlay routines. I found GUSPlay's source very handy to edit for my own 
  28.  purposes so I started to work on it. I have also studied GusMod and DSMI 
  29.  sources. Ok. Here's the thanks list:
  30.  
  31.           Biggest thanks to Robert Adolfsson for GUSPlay
  32.           Other thanks to:
  33.              Joshua Jensen for GusMod
  34.              Otto Chrons for DSMI and DMP
  35.              Jussi Lahdenniemi for PMP
  36.              Christian Kuendig for ZZPlay
  37.              Phantom for ProTracker for GUS
  38.              PSi for MDP
  39.              Stephan Danes and Ramon von Gorkom for Inertia Player
  40.              Jaakko Lehtinen for JMP
  41.              Mr.H for FastTracker
  42.              Henning Hellström for SB Studio
  43.              All Capacala members for beta testing
  44.              Delorean for great modules
  45.              Erika Launonen for herself
  46.  
  47.  
  48.      2. THE USAGE
  49.  
  50.    Here's the command line syntax:
  51.  
  52.            CMOD [modname] [@listfile] /options
  53.  
  54.     modname: Module name(s), wildcards allowed
  55.    listfile: A file containing module names
  56.  
  57.     options: Axx    -   set amplification ( 0-28, default = 24 )
  58.              Pxx    -   set default panning ( 0-64, default = 18 )
  59.              Fx     -   set fadespeed ( 0-9, default = 9 )
  60.              Lx     -   set module looping ( 0 or 1 )
  61.              0      -   disable speed zero
  62.  
  63.    CapaMod begins by loading the first module and invoking the main screen. 
  64.  Video mode will be changed to 80x50 so all of the necessery information may
  65.  be shown. On top of screen you can see some useful information about module 
  66.  and location where the player currently is. On the right side there is the
  67.  clock and the playing time.
  68.    Under this info are the channel indicator lines. They show the sample
  69.  name, effect, volume, pitch and panning of each channel. The volume bars,
  70.  which are also in this section of a screen, are standard module-bars. They
  71.  don't even try to be any kind of VU-meters. Information text is black if the 
  72.  sample is triggered during the current row position.
  73.    And under all this, there is the sample information. There you can find
  74.  sample names, lengths, loops, finetunes and channel which they are being play-
  75.  ed on. Current sample is highlighted. If sample is muted its information is
  76.  shown in dark colors.
  77.  
  78.    You can use the following keys to control playing and other stuff:
  79.  
  80.               /   -   set module position
  81.               /   -   move cursor
  82.              Tab    -   change cursor location between samples and channels
  83.              Space  -   mute / release a channel or a sample
  84.              M      -   mute / release all channels or samples
  85.              1 - 8  -   mute / release a channel indicated by the numberkey
  86.              F1-F10 -   set fadespeed ( F10 fade off ) 
  87.              - / +  -   set volume
  88.              , / .  -   set panning of channel
  89.              ; / :  -   set panning of channel 4 steps
  90.            Home/End -   set tempo
  91.             PgD/PgU -   set speed
  92.              Del    -   set speed & tempo determined by the module
  93.              N      -   fade out and load next module,
  94.                         another N stops fading and starts loading immediately
  95.              Esc    -   fade out and quit,
  96.                         another Esc stops fading and quits immediately
  97.              D      -   dos shell
  98.              P      -   pause / release module
  99.              H      -   help and other info
  100.              L      -   switch looping on/off
  101.              0      -   enable/disable speed zero
  102.  
  103.  
  104.      3. CONTACTING THE AUTHOR ( an old cliché )
  105.    
  106.    If you find any bugs or encounter some problems, don't hesitate to contact
  107.  me. You can also just write me a card where you tell how good CapaMod is and 
  108.  how good I am ( just like Otto wants, greets to him by the way ).
  109.  
  110.      Mail:  Heikki Ylinen        Modem:  DARKSíDE BBS the Capacala WHQ
  111.             Oravatie 9b                  +358-0-294 1594   node 1
  112.             02270 Espoo                  +358-0-294 0467   node 2
  113.             Finland
  114.  
  115.  
  116.      4. THE END
  117.